home *** CD-ROM | disk | FTP | other *** search
/ United Public Domain Gold 2 / United Public Domain Gold 2.iso / utilities / pu737.dms / pu737.adf / PrtSc / PrtSc.DOC < prev    next >
Text File  |  1994-11-03  |  10KB  |  259 lines
  1. ----------------------------------------------------------------------------------
  2. main
  3. ----------------------------------------------------------------------------------
  4.                                 PrtSc V1.75
  5.                               by Jan Hagqvist
  6.  
  7. 'COPYRIGHT        '
  8. 'DISCLAIMER       '
  9. 'What is PrtSc?   '
  10. 'How does it work?'
  11. 'How do I use it? '
  12. 'Notes            '
  13. 'Contact          '
  14. 'History          '
  15.  
  16. ----------------------------------------------------------------------------------
  17. copyright
  18. ----------------------------------------------------------------------------------
  19. COPYRIGHT
  20.  
  21.     Copyright (c) 1993, Jan Hagqvist, All Rights Reserved.
  22.  
  23.     This program is 'SHAREWARE'. You may freely use and distribute this
  24.     program under the following conditions:
  25.  
  26.     1) No modifications are made into the program or this documentation
  27.        and all the files are spread together. However, you are allowed
  28.        to compress all the files into an archive for distribution.
  29.  
  30.     2) No money (other than nominal copying fees) is charged for its
  31.        distribution.
  32.  
  33.     3) You may freely test the program and if you like it and find it
  34.        useful, it would be advisable (and greatly appreciated), if you
  35.        would send me the $3 registration fee. It is all up to you.
  36.  
  37. ----------------------------------------------------------------------------------
  38. disclaimer
  39. ----------------------------------------------------------------------------------
  40. DISCLAIMER
  41.  
  42.     THIS PROGRAM IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND,
  43.     EITHER EXPRESSED OR IMPLIED. THE AUTHOR WILL NOT BE LIABLE FOR
  44.     ANY DAMAGES, DIRECT, INDIRECT, INCIDENTAL OR CONSEQUENTIAL,
  45.     RESULTING FROM THE USE OF THE PROGRAM. THE ENTIRE RISK AS TO THE
  46.     USE OF THIS PROGRAM IS ASSUMED BY THE USER.
  47.  
  48. ----------------------------------------------------------------------------------
  49. whatis
  50. ----------------------------------------------------------------------------------
  51. What is PrtSc?
  52.  
  53.     PrtSc is a little utility that makes the PrtSc-key to work as it
  54.     should, so by pressing the 'PrtSc-key', you get a dump of the foremost
  55.     screen. PrtSc needs DOS2.0 (V36).
  56.  
  57. ----------------------------------------------------------------------------------
  58. howwork
  59. ----------------------------------------------------------------------------------
  60. How does it work?
  61.  
  62.     PrtSc waits you to press the 'PrtSc-key' and when pressed, it dumps
  63.     the current screen via printer.device using the current printer
  64.     'preferences'. PrtSc works in the background, so it should't slow
  65.     the machine down a lot. At least I've used it for months without
  66.     even remembering it's there.
  67.  
  68. ----------------------------------------------------------------------------------
  69. howuse
  70. ----------------------------------------------------------------------------------
  71. How do I use it?
  72.  
  73.     Copy the program to your c: drawer and execute it from there with
  74.     the 'run' command. PrtSc uses the printer.device so it should be in
  75.     the devs: drawer. All the 'other files' that are needed to print
  76.     something, need to be in their own drawers too.
  77.       To get a dump of the foremost screen press the Shift and PrtSc-keys.
  78.     There's no matter which Shift you use, the Left or the Right, both
  79.     should do. The PrtSc-key should be found on the numeric keypad. In my
  80.     (A500) keyboard it is with the '*'-key.
  81.  
  82.  
  83.     The options window:
  84.  
  85.     To enter to the options window, press Alt and PrtSc. The gadgets are
  86.     used to alter the output and work as follows:
  87.  
  88.     Reset before/after: If you can't get your printer to print when these
  89.     flags are off, try setting the reset before flag, because your printer
  90.     might need resetting before it can dump the image.
  91.  
  92.     Aspect: Selecting this gadget makes the other dimension of the dump
  93.     to be scaled, so that the dump has the same aspect ratio as the
  94.     screen.
  95.  
  96.     Center: Centers the image between the left and right edge of the
  97.     paper.
  98.  
  99.     No formfeed: Prevents the page to be ejected after the dump.
  100.  
  101.     Full rows: The height of the image is set to the maximum possible, as
  102.     determined by the printer limits.
  103.  
  104.     Full columns: The width of the image is set to the maximum possible,
  105.     as determined by the printer limits.
  106.  
  107.     ActiveScreen/FirstScreen: This cycle gadget lets you choose whether
  108.     to print the ActiveScreen or the FirstScreen when you press PrtSc.
  109.     The ActiveScreen is the screen currently active (selected) and the
  110.     FirstScreen is the first (frontmost) screen in the Intuition screens
  111.     list.
  112.  
  113.     Dump screen/Save screen: This one lets you to choose whether to dump
  114.     the screen to the printer or save it onto a disk when the PrtSc-key
  115.     is pressed.
  116.  
  117.     File: Enter the name of the ILBM file to save into this gadget.
  118.  
  119.     Save: Saves the gadget states in the file 's:PrtSc.cfg'. The file is
  120.     automatically loaded on the startup, if it exists.
  121.  
  122.     Quit: Simply quits the program.
  123.  
  124.     To exit the options window select the CloseWindow-gadget (the program
  125.     will still be running).
  126.  
  127. ----------------------------------------------------------------------------------
  128. notes
  129. ----------------------------------------------------------------------------------
  130. Notes
  131.  
  132.     - To alter the preferences that are not defined internally in PrtSc,
  133.       use the PrinterGfx program on your Workbench-disk, in the Prefs-
  134.       drawer.
  135.  
  136.     - I'm not sure if every option works, but I have found that at least
  137.       both of the reset options, center and ActiveScreen/FirstScreen do
  138.       work with my Mannesmann Tally 81.
  139.  
  140.     - Now the window is opened to its previous place, so if you move the
  141.       window around before closing it, next time the window is opened,
  142.       it will be on the place where you put it. Note: If you have the
  143.       window open on the far edge of the screen and then reduce the
  144.       screens size, next time the window is opened, it will try to open
  145.       outside the screen and the open fails.
  146.  
  147.     - When you open the options window, the Workbench screen will be
  148.       brought to front and when you close the window, the screen which was
  149.       the frontmost before the open, will be brought back into front.
  150.  
  151.     - If nothing happens when you press the PrtSc-key, try pressing it
  152.       longer. If nothing still happens, try something like 'list to prt:'
  153.       to see if you get that printed. If nothing happens, check the
  154.       connections and that all the system files needed to print are
  155.       placed correctly.
  156.  
  157.     - Though this program is ShareWare, you don't need to pay anything to
  158.       use it. But if you really like it, I would appreciate some $3 with
  159.       some comments how the program runs on your machine or maybe a
  160.       printout made by it.
  161.  
  162.     - There is nothing disabled in this version, this is the full and
  163.       complete version of the program.
  164.  
  165.     - Special thanks go to Barlow Soper, for your help.
  166.  
  167.     - And now a bit of Finnish:
  168.       Terveisiä Kotkasta! On mukavaa, että juuri sinä olet kiinnostunut
  169.       tästä pienestä ohjelmasta, arvoisa käyttäjä. Toivon, että ohjelma
  170.       toimii hyvin koneessasi, eikä aiheuta sinulle turhaa päänvaivaa.
  171.       Jos todella pidät tästä ohjelmasta, olisi mukavaa saada palautetta
  172.       tai mahdollisesti parannusehdotuksia. Kiitos kiinnostuksestasi tätä
  173.       ohjelmaa kohtaan.
  174.       If you understood the standard written Finnish (are you a Finn?)
  175.       try this (spoken Finnish):
  176.       Terveisii Kotkast! On tosi kiva nähä, et just sä oot kiinnostunu
  177.       mun pikku ohjelmast. Mä todella toivon, et tää ohjelma toimii
  178.       hyvin sun koneessas, eikä sul oo mitää vaikeuksii tän ohjelman kans.
  179.  
  180.     - How about you to learn the Finnish language? We've got only some 15
  181.       cases in the Finnish language and no prepositions (some examples:
  182.       koti=home, kodin=homes=of home, kodissa=in home, kotiin=to home,
  183.       kodista=from home, kotona=at home etc.)
  184.       If you still want to learn Finnish, how about tuning to Radio
  185.       Finland on 558kHz, 963kHz (MW, Europe), (for other frequencies, try
  186.       scanning the SW). They've got broadcasts in Finnish, Swedish,
  187.       English (Starting Finnish etc.), German, French, Russian and of
  188.       course in Latin! And no, I'm not working for them.
  189.  
  190.     - A1200/A4000 users: do you have any problems using the program?
  191.  
  192. ----------------------------------------------------------------------------------
  193. contact
  194. ----------------------------------------------------------------------------------
  195. Contact
  196.  
  197.     If you have any comments, bug reports, bribes or shuttle tickets to
  198.     the moon :-), please contact me at:
  199.  
  200.  
  201.     EMail:
  202.  
  203.     Fidonet    Jan Hagqvist @ 2:220/861
  204.     InterNet   Jan.Hagqvist@ursa.fi
  205.  
  206.  
  207.     SnailMail:
  208.  
  209.     Jan Hagqvist
  210.     Reinolankatu 5 A 1
  211.     48600 KARHULA
  212.     FINLAND
  213.  
  214. ----------------------------------------------------------------------------------
  215. history
  216. ----------------------------------------------------------------------------------
  217. History
  218.  
  219. V1.07    (Wednesday, 3 March 1993)
  220.     The first usable version of this program. There are no options yet.
  221.     The print size should be as many pixels as the screen size is. V37
  222.     is required.
  223.     Size = 1084 bytes
  224.  
  225. V1.08    (Wednesday, 23 June 1993)
  226.     A very minor update. I browsed the Kernel Manual and realized that
  227.     this might even work on V36 machines, so now it needs V36 to work.
  228.     Size = 1084 bytes
  229.  
  230. V1.50    (Thursday, 30 September 1993)
  231.     Fed up with creating a new version every other Wednesday, I finished
  232.     this one Thursday. Some would say it's a major update, now containing
  233.     a simple (disordered) options window, with some print options and
  234.     Save config/Quit-options. Still doesn't eat the '*'-char, when you
  235.     press Shift/Alt+PrtSc (though you can get rid of it by altering your
  236.     keymap).
  237.     Size = 3528 bytes
  238.  
  239. V1.52    (Wednesday, 13 October 1993)
  240.     Yet another Wednesday edition. Now the program creates a little input-
  241.     handler to eat the '*'-char, when PrtSc is pressed with a Shift or Alt
  242.     key. No need to use a script from Workbench anymore, the program can
  243.     handle the Workbench startup-message.
  244.     Size = 3980 bytes
  245.  
  246. V1.55    (Tuesday, 19 October 1993)
  247.     Now the proggy uses GadTools gadgets for the better looks. Should I
  248.     consider a career of a beautician, or what? Or maybe I should become a
  249.     student of English language, so that you could better understand me.
  250.     At least I can understand what I'm writing in here. 
  251.     Size = 3504 bytes
  252.  
  253. V1.75    (Saturday, 12 March 1994)
  254.     Since nobody has sent me any suggestions about how to improve the
  255.     program, I decided to make up some myshelf. Now you can also save
  256.     the screen into a file instead of dumping it onto paper. So no printer
  257.     is necessary anymore to use the program.
  258.     Size = 4468 bytes
  259.